Aviation API
2 Meteorological Terminal Aerodrome Reports (METARs)
Meteorological Terminal Aerodrome Reports are aviation routine weather reports issued at hourly or half-hourly intervals. It is a summary of the meteorological elements observed at an airport at a specific time. SPECI is a sub type of METAR issued when a non-routine weather report is created when a critical meteorological condition is observed.
2.1 Latest for a Location
Request the latest METAR issued for a specific airport location. Any supported 4-letter airport ICAO code is accepted.
2.1.1 API Call:
GET /aviation/metar/{location}/latest2.1.2 Parameters:
2.1.2.1 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| location | NZWN | A supported 4-letter airport ICAO code. The ICAO code must be uppercase. This parameter is Mandatory. |
2.1.2.2 Query Parameters:
| Query Parameter | Example | Description |
|---|---|---|
| format | geojson | Specifying this parameter will result in the forecast information contained in the METAR being returned in a GeoJSON format. Valid values: json (default) geojson This parameter is Optional. |
2.1.3 Example:
This example would return the latest report for Wellington airport.
GET /aviation/metar/NZWN/latest2.1.4 API Response:
{
"version":"1.0",
"issue-time":"2018-01-15T22:38:35Z",
"path":"/metar/NZWN/latest",
"response":[
{
"met:domain":"aviation",
"met:product-name":"metar",
"av:metar-location":"NZWN",
"met:valid-at":"2018-01-15T22:30:00Z",
"met:data":"METAR NZWN 152230Z AUTO 01013KT 9999 BKN050/// 23/17 Q1018 NOSIG RMK\nKAUKAU 33015KT="
}
]
}2.2 Last n hours for a Location
Request up to 24 hours of METAR’s for a specific airport location. Any supported 4-letter airport
ICAO code is accepted.
2.2.1 API Call:
GET /aviation/metar/{location}/last/{n}/hours2.2.2 Parameters:
2.2.2.1 Path Parameters:
| Path Parameter | Example | Description |
|---|---|---|
| location | NZWN | A supported 4-letter airport ICAO code. The ICAO code must be uppercase. This parameter is Mandatory. |
| n | 3 | This is between 1 and 24 hours data. This parameter is Mandatory. |
2.2.2.2 Query Parameters:
| Query Parameter | Example | Description |
|---|---|---|
| format | geojson | Specifying this parameter will result in the forecast information contained in the TAF being returned in a GeoJSON format. Valid values: json (default) geojson This parameter is Optional. |
2.2.3 Example:
This example would return all METAR’s issued in the last 3 hours for Wellington airport in GeoJSON format..
GET /aviation/metar/NZWN/last/2/hours?format=geojson2.2.4 API Response:
{
"version": "1.0",
"issue-time": "2022-07-05T03:10:21Z",
"path": "/aviation/api/aviation/metar/NZWN/last/2/hours?format=geojson",
"response": [
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
174.7999,
-41.3333,
4
]
},
"properties": {
"reportStatus": "NORMAL",
"location": "NZWN",
"issueTime": "2022-07-05T03:00:00Z",
"observationTime": "2022-07-05T03:00:00Z",
"observation": [
{
"cloudAndVisibilityOK": false,
"airTemperature": {
"value": 13.0,
"unit": "Cel"
},
"dewpointTemperature": {
"value": 9.0,
"unit": "Cel"
},
"qnh": {
"value": 1016,
"unit": "hPa"
},
"surfaceWind": {
"meanWindDirection": {
"value": 350,
"unit": "deg"
},
"meanWindSpeed": {
"value": 15.0,
"unit": "Kn"
},
"extremeClockwiseWindDirection": {
"value": 10,
"unit": "deg"
},
"extremeCounterClockwiseWindDirection": {
"value": 310,
"unit": "deg"
}
},
"horizontalVisibility": {
"operator": "ABOVE",
"value": 9999,
"unit": "m"
},
"cloud": {
"layer": [
{
"amount": "Scattered",
"base": {
"value": 2800,
"unit": "Ft"
}
},
{
"amount": "Broken",
"base": {
"value": 6000,
"unit": "Ft"
}
},
{
"amount": "Overcast",
"base": {
"value": 9500,
"unit": "Ft"
}
}
]
}
}
],
"forecast": {
"noSignificantChange": true
}
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
174.7999,
-41.3333,
4
]
},
"properties": {
"reportStatus": "NORMAL",
"location": "NZWN",
"issueTime": "2022-07-05T02:30:00Z",
"observationTime": "2022-07-05T02:30:00Z",
"observation": [
{
"cloudAndVisibilityOK": false,
"airTemperature": {
"value": 14.0,
"unit": "Cel"
},
"dewpointTemperature": {
"value": 9.0,
"unit": "Cel"
},
"qnh": {
"value": 1017,
"unit": "hPa"
},
"surfaceWind": {
"meanWindDirection": {
"value": 340,
"unit": "deg"
},
"meanWindSpeed": {
"value": 13.0,
"unit": "Kn"
},
"windGustSpeed": {
"value": 26.0,
"unit": "Kn"
},
"extremeClockwiseWindDirection": {
"value": 10,
"unit": "deg"
},
"extremeCounterClockwiseWindDirection": {
"value": 310,
"unit": "deg"
}
},
"horizontalVisibility": {
"operator": "ABOVE",
"value": 9999,
"unit": "m"
},
"cloud": {
"layer": [
{
"amount": "Scattered",
"base": {
"value": 2700,
"unit": "Ft"
}
},
{
"amount": "Scattered",
"base": {
"value": 6000,
"unit": "Ft"
}
},
{
"amount": "Broken",
"base": {
"value": 7000,
"unit": "Ft"
}
}
]
}
}
],
"forecast": {
"noSignificantChange": true
}
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
174.7999,
-41.3333,
4
]
},
"properties": {
"reportStatus": "NORMAL",
"location": "NZWN",
"issueTime": "2022-07-05T02:00:00Z",
"observationTime": "2022-07-05T02:00:00Z",
"observation": [
{
"cloudAndVisibilityOK": false,
"presentWeather": [
"Light precipitation of rain"
],
"airTemperature": {
"value": 14.0,
"unit": "Cel"
},
"dewpointTemperature": {
"value": 9.0,
"unit": "Cel"
},
"qnh": {
"value": 1017,
"unit": "hPa"
},
"surfaceWind": {
"meanWindDirection": {
"value": 340,
"unit": "deg"
},
"meanWindSpeed": {
"value": 11.0,
"unit": "Kn"
},
"extremeClockwiseWindDirection": {
"value": 20,
"unit": "deg"
},
"extremeCounterClockwiseWindDirection": {
"value": 310,
"unit": "deg"
}
},
"horizontalVisibility": {
"operator": "ABOVE",
"value": 9999,
"unit": "m"
},
"cloud": {
"layer": [
{
"amount": "Broken",
"base": {
"value": 7000,
"unit": "Ft"
}
},
{
"amount": "Overcast",
"base": {
"value": 9000,
"unit": "Ft"
}
}
]
}
}
],
"forecast": {
"noSignificantChange": true
}
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
174.7999,
-41.3333,
4
]
},
"properties": {
"reportStatus": "NORMAL",
"location": "NZWN",
"issueTime": "2022-07-05T01:30:00Z",
"observationTime": "2022-07-05T01:30:00Z",
"observation": [
{
"cloudAndVisibilityOK": false,
"airTemperature": {
"value": 14.0,
"unit": "Cel"
},
"dewpointTemperature": {
"value": 10.0,
"unit": "Cel"
},
"qnh": {
"value": 1017,
"unit": "hPa"
},
"surfaceWind": {
"meanWindDirection": {
"value": 330,
"unit": "deg"
},
"meanWindSpeed": {
"value": 10.0,
"unit": "Kn"
},
"windGustSpeed": {
"value": 23.0,
"unit": "Kn"
},
"extremeClockwiseWindDirection": {
"value": 10,
"unit": "deg"
},
"extremeCounterClockwiseWindDirection": {
"value": 280,
"unit": "deg"
}
},
"horizontalVisibility": {
"operator": "ABOVE",
"value": 9999,
"unit": "m"
},
"cloud": {
"layer": [
{
"amount": "Scattered",
"base": {
"value": 2400,
"unit": "Ft"
}
},
{
"amount": "Broken",
"base": {
"value": 8000,
"unit": "Ft"
}
}
]
}
}
],
"forecast": {
"noSignificantChange": true
}
}
}
]
}
]
}